home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 151-175 / disk_164 / newzap / newzap.docs < prev    next >
Text File  |  1992-05-06  |  4KB  |  83 lines
  1.        NewZAP: Program and Documentation (c) 1986 Proprietary Products
  2.                    
  3.                  
  4. WHAT IS NEWZAP?
  5. ===============
  6.  
  7.     NewZAP is a multi-purpose file sector editing utility. If you've
  8. ever had the need to alter just a few bytes within a file, examine its
  9. binary and ASCII representations, or search for key sequences of digits
  10. or characters, NewZAP will make your hacking life a little bit easier.
  11. It does what text editors were not meant to do; precise position-oriented
  12. object modifications.  NewZAP will run from CLI or Workbench under 1.1 or
  13. 1.2 KickStart with or without FAST RAM.
  14.  
  15. ORIGINS & CREDITS
  16. =================
  17.  
  18.     NewZAP is a third-generation ZAP utility in the sense that it
  19. descended from Apparat's Z-80 based SuperZap to FileZAP (Fred Fish disk
  20. #10) to the current.  NewZAP was compiled under 16-bit Aztec "C", with
  21. graphics, fontwork and debugging assisted by with Deluxe Paint, FontEdit,
  22. and MetaScope, respectively. Thanx to Scott Saunders for the competitive
  23. edge, Mike Lehman for the much-needed documentation, and to R.J. Mical for
  24. "A Final Note on Style".
  25.  
  26. Beverages provided by the Coca-Cola Company and Molson Breweries of Canada,
  27. Ltd.
  28.     
  29. USAGE
  30. =====
  31.  
  32.     The calling sequence from CLI is NewZAP [filename], where filename
  33. is the optional initial file to edit.  From Workbench, just click on the
  34. gadget.  The rest of the program is... well, self-explanatory!  The current
  35. file can be changed at any time by editing the filename string gadget,
  36. writing out any changes to the previous file before switching. Simply click
  37. on the HEX or ASCii windows to reflect the current editing mode.  The cursor
  38. can be moved by rolling the mouse with the left button down, or by using the
  39. arrow keys.  Note that each window wraps to the next; i.e., you can click on
  40. the HEX window, move the cursor over the the ASCii side, and edit the ASCii
  41. position while still in HEX mode.
  42.  
  43.     As in FileZAP, you cannot edit past the EOF byte in the last record.
  44. Unlike FileZAP, NewZAP displays and edits full 512-byte sectors via a 106 
  45. character wide internal font.  Most commands are duplicated with matching
  46. command sequences; an exception being the HELP key, which brings up the
  47. "About..." menuitem.  Disk errors and sector writes are flagged with a
  48. non-abusive audible "beep".
  49.  
  50.     The Search menu is unique to NewZAP.  Use it to check for strings
  51. or HEX digits, forward or backward, with or without caps matching.  Tired of
  52. batch files that grind your disk drive?  Use NewZAP's Search, Edit and Save
  53. functions to modify both instances of ":T" to "T:" in C:EXECUTE.  Execute
  54. will henceforth store its preprocessed batch files anywhere you want provided
  55. you have ASSIGNed T: to someplace!  I recommend ASSIGNing T: to RAM: in your
  56. Startup-Sequence for ultra-fast EXECUTEs.
  57.  
  58. CAVEATS
  59. =======
  60.  
  61.     Some folk have requested the ability to extend files. Well, the
  62. original didn't support it so neither does NewZAP. I've rarely had a need
  63. for this, but perhaps future versions will support it if the demand is great.
  64.  
  65.     NewZAP expects an 80-column environment for its titles and gadgets.
  66. If you haven't set Preferences yet, do so!
  67.  
  68.     NewZAP is a two-edged sword, and can DESTROY object files with
  69. careless editing.  My advice : work on backup copies.
  70.  
  71.     Lastly, NewZAP is shareware, a concept where authors can release
  72. high-quality software at low cost and risk to users.  If you like it, 
  73. contribute something to the kitty. If you don't, pass it on.  A $15 donation 
  74. will put you on the upgrade list, so you can receive the next major revision
  75. on disk via U.S. Postal service.  ENCOURAGE USER-SUPPORTED SOFTWARE! The 
  76. author can be reached at :
  77.  
  78.  
  79.                            Proprietary Products
  80.                              c/o John Hodgson
  81.                               P.O. Box 1643
  82.                        Pebble Beach, Ca. 93953-1643
  83.